home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / language / abcst.arc / ABC.HLP next >
Text File  |  1990-01-05  |  21KB  |  465 lines

  1. SUMMARY OF SPECIAL ACTIONS
  2.  
  3.   :name   Visit how-to called 'name'
  4.   :       Visit last how-to refered to
  5.   ::      Display headings of how-to's in this workspace
  6.  
  7.   =name   Visit contents of location
  8.   =       Visit last location visited
  9.   ==      Display names of permament locations in this workspace
  10.  
  11.   >name   Visit workspace 'name'
  12.   >       Visit last workspace visited
  13.   >>      Display list of workspace names
  14.  
  15.   QUIT    Leave ABC
  16.  
  17. SUMMARY OF EDITING OPERATIONS
  18.  
  19.   Name      Default Keys*    Short description
  20.  
  21.   Accept    [TAB]            Accept suggestion, focus to hole or end of line
  22.   Return    [RETURN]         Add line or decrease indentation
  23.  
  24.   Widen     f1, [ESC] w      Widen focus
  25.   Extend    f2, [ESC] e      Extend focus (usually to the right)
  26.   First     f3, [ESC] f      Move focus to first contained item
  27.   Last      f4, [ESC] l      Move focus to last contained item
  28.  
  29.   Previous  f5, [ESC] p      Move focus to previous item
  30.   Next      f6, [ESC] n      Move focus to next item
  31.   Upline    f7, [ESC] u      Move focus to whole line above
  32.   Downline  f8, [ESC] d      Move focus to whole line below
  33.  
  34.   Up        ^, [ESC] U       Make new hole, move up
  35.   Down      v, [ESC] D       Make new hole, move down
  36.   Left      <-, [ESC] ,      Make new hole, move left
  37.   Right     ->, [ESC] .      Make new hole, move right
  38.  
  39.   Goto      [ctrl-G], mouseclick  New focus at cursor position
  40.  
  41.   Undo      [BACKSPACE]      Undo effect of last key pressed (may be repeated)
  42.   Redo      [ctrl-U]         Redo last UNDOne key (may be repeated)
  43.  
  44.   Copy      f9, [ctrl-C], [ESC]c  Copy buffer to hole, or focus to buffer
  45.   Delete    [ctrl-D]         Delete contents of focus (to buffer if empty)
  46.  
  47.   Record    [ctrl-R]         Start/stop recording keystrokes
  48.   Play      [ctrl-P]         Play back recorded keystrokes
  49.  
  50.   Look      [ctrl-L]         Redisplay screen
  51.   Help      f10, [ESC]?      Print summary of editing operations
  52.  
  53.   Exit      [ctrl-X]         Finish changes or execute command
  54.   Interrupt (as set by 'stty')Interrupt command execution
  55.   Suspend (as set by 'stty') Suspend ABC (only for shell with job control)
  56.  
  57.   * Notes:
  58.  
  59.   [Ctrl-D] means: hold the [CTRL] (or [CONTROL]) key down while pressing d.
  60.  
  61.   [ESC] w means: press the [ESC] key first, then w.
  62.  
  63. ABC QUICK REFERENCE
  64.  
  65.   COMMANDS
  66.  
  67.   WRITE expr                    Write to screen;
  68.                                 / before or after expr gives new line
  69.   READ address EG expr          Read expression from terminal to address;
  70.                                 expr is example
  71.   READ address RAW              Read line of text
  72.   PUT expr IN address           Put value of expr in address
  73.   SET RANDOM expr               Start random sequence for random and choice
  74.   REMOVE expr FROM list         Remove one element from list
  75.   INSERT expr IN list           Insert in right place
  76.   DELETE address                Delete permanent location or table entry
  77.   PASS                          Do nothing
  78.   KEYWORD expr KEYWORD ...      Execute user-defined command
  79.   KEYWORD                       Execute refined command
  80.  
  81.   CHECK test                    Check test and stop if it fails
  82.   IF test:                      If test succeeds, execute commands;
  83.      commands                       no ELSE allowed
  84.   SELECT:                       Select one alternative:
  85.       test: commands                 try each test in order
  86.       ...                            (one must succeed;
  87.       test: commands                 the last test may be ELSE)
  88.   WHILE test:                   As long as test succeeds
  89.      commands                       execute commands
  90.   FOR name,... IN train:        Take each element of train in turn
  91.      commands
  92.  
  93.   HOW-TO's
  94.  
  95.   HOW TO KEYWORD ...:           Define new command KEYWORD ...
  96.      commands
  97.   HOW TO RETURN f:              Define new function f with no arguments
  98.      commands                      (returns a value)
  99.   HOW TO RETURN f x:            Define new function f with one argument
  100.      commands
  101.   HOW TO RETURN x f y:          Define new function f with two arguments
  102.      commands
  103.   HOW TO REPORT pr:             Define new predicate pr with no arguments
  104.      commands                      (succeeds/fails)
  105.   HOW TO REPORT pr x:           Define new predicate pr with one argument
  106.      commands
  107.   HOW TO REPORT x pr y:         Define new predicate pr with two arguments
  108.      commands
  109.  
  110.   SHARE name,...                Share permanent locations
  111.                                 (before commands of how-to)
  112.  
  113.   Refinements (after the commands of a how-to)
  114.  
  115.   KEYWORD : commands            Define command refinement
  116.   name: commands                Define expression- or test-refinement
  117.  
  118.   Terminating commands
  119.  
  120.   QUIT                          Leave command how-to or command refinement,
  121.                                 or leave ABC
  122.   RETURN expr                   Leave function how-to or expression refinement,
  123.                                 return value of expr
  124.   REPORT test                   Leave predicate how-to or test-refinement,
  125.                                 report outcome of test
  126.   SUCCEED                       The same, report success
  127.   FAIL                          The same, report failure
  128.  
  129.   EXPRESSIONS AND ADDRESSES
  130.  
  131.   666, 3.14, 3.14e-9            Exact constants
  132.  
  133.   expr,expr,...                 Compound
  134.   name,name,...                 Naming (may also be used as address)
  135.  
  136.   text@p                        "ABCD"@2 = "BCD" (also address)
  137.   text|q                        "ABCD"|3 = "ABC" (also address)
  138.   text@p|q                      "ABCD"@2|1 = "BCD"|1 = "B"
  139.  
  140.   table[expr]                   Table selection (also address)
  141.  
  142.   "Jan", 'Feb', 'Won''t!'       Textual displays (empty: "" or '')
  143.   "value = `expr`;"             Conversion of expr to text
  144.  
  145.   {1; 2; 2; ...}                List display (empty: {})
  146.   {1..9; ...}, {"a".."z"; ...}  List of consecutive values
  147.  
  148.   {["Jan"]: 1; ["Feb"]: 2; ...} Table display (empty: {})
  149.  
  150.   f, f x, x f y                 Result of function f (no permanent effects)
  151.   name                          Result of refinement (no permanent effects)
  152.  
  153.   TESTS
  154.  
  155.   x < y, x <= y, x >= y, x > y  Order tests
  156.   x = y, x <> y                      (<> means 'not equals')
  157.   0 <= d < 10
  158.  
  159.   pr, pr x, x pr y              Outcome of predicate pr (no permanent effects)
  160.   name                          Outcome of refinement (no permanent effects)
  161.  
  162.   test AND test AND ...         Fails as soon as one of the tests fails
  163.   test OR test OR ...           Succeeds as soon as one of the tests succeeds
  164.   NOT test
  165.  
  166.   SOME name,... IN train HAS test
  167.                                 Sets name, ... on success
  168.   EACH name,... IN train HAS test
  169.                                 Sets name, ... on failure
  170.   NO   name,... IN train HAS test
  171.                                 Sets name, ... on failure
  172.  
  173.   PREDEFINED FUNCTIONS AND PREDICATES
  174.  
  175.   Functions and predicates on numbers
  176.  
  177.   ~x                            Approximate value of x
  178.   exactly x                     Exact value of x
  179.   exact x                       Test if x is exact
  180.   +x, x+y, x-y, -x, x*y, x/y    Plain arithmetic
  181.   x**y                          x raised to the power y
  182.   root x, n root x              Square root, n-th root
  183.   abs x, sign x                 Absolute value, sign (= -1, 0, or +1)
  184.   round x, floor x, ceiling x   Rounded to whole number
  185.   n round x                     x rounded to n digits after decimal point
  186.   a mod n                       Remainder of a on division by n
  187.   */x                           Numerator of exact number x
  188.   /*x                           Denominator
  189.   random                        Random approximate number r, 0 <= r < 1
  190.   e, exp x                      Base of natural logarithm, exponential function
  191.   log x, b log x                Natural logarithm, logarithm to the base b
  192.   pi, sin x, cos x, tan x, arctan x
  193.                                 Trigonometric functions, with x in radians
  194.   angle (x, y), radius (x, y)   Angle of and radius to point (x, y)
  195.   c